<!DOCTYPE html>
<html>

  <head>
    <meta charset='utf-8'>
    <meta http-equiv="X-UA-Compatible" content="chrome=1">
    <meta name="description" content="AndroidSVG : SVG rendering library for Android">

    <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">

    <title>AndroidSVG</title>
  </head>

  <body>

    <!-- HEADER -->
    <div id="header_wrap" class="outer">
        <header class="inner">
          <a id="forkme_banner" href="https://github.com/BigBadaboom/androidsvg">View on GitHub</a>

          <a href="index.html"><img id="project_logo" src="images/AndroidSVG_logo.svg" title="AndroidSVG logo"/></a>
          <h1 id="project_title">AndroidSVG</h1>
          <h2 id="project_tagline">SVG rendering library for Android</h2>

        </header>
    </div>

    <!-- MAIN CONTENT -->
    <div id="main_content_wrap" class="outer">
      <div class="inner">
        <nav>
          <ul>
            <li><a href="index.html">Home</a></li>
            <li><a href="download.html">Download</a></li>
            <li><a href="release_notes.html">Release Notes</a></li>
            <li><a href="doc/index.html">Javadoc</a></li>
            <li><a href="documentation.html">Documentation</a></li>
            <li><a href="svg_implementation_details.html">SVG Implementation</a></li>
            <li><a href="faq.html">FAQ</a></li>
            <li><a href="known_issues.html">Known Issues</a></li>
            <li><a href="report_bugs.html">Report a bug</a></li>
            <li><a href="mailto:androidsvgfeedback@gmail.com">Contact the author</a></li>
          </ul>

          <p><em><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License v2.0</a></em></p>

          <p><a href="https://twitter.com/AndroidSVG"><img src="images/twitter.png"></a></p>
        </nav>
        <section id="main_content">
        <h1><a id="androidsvg" class="anchor" href="#androidsvg" aria-hidden="true"><span class="octicon octicon-link"></span></a>Known Issues</h1>






<h3><a name="Renderer_features_that_do_not_work_on_some_versions_of_Android"></a>Renderer features that do not work on some versions of Android</h3>
 
<h4>Android prior to 4.2</h4>

<h5>Stroked underline text</h5>
<p>
<strong>Stroking of underlined or strikethrough text is broken</strong> in versions of Android <strong>prior to 4.2</strong>.
AndroidSVG will not attempt to stroke underlines or strikethroughs when running on Android 4.1 or earlier.
</p>


<hr/>


<h4>Android 4.3</h4>

<h5>Clip paths</h5>
<p>
There is a bug in <strong>Android 4.3</strong> that has the effect of <strong>breaking the <code>&lt;clipPath&gt;</code> feature
when using <code>renderToPicture()</code></strong>.  Any SVG files that use a <code>&lt;clipPath&gt;</code> will not render correctly.
See <a href="https://code.google.com/p/android/issues/detail?id=58737" rel="nofollow">Android issue 58737</a>.  If you are
using <code>renderToCanvas()</code>, you will not be affected.</li>
</p>


<h4>Android 6.0</h4>

<h5>Clip paths (again)</h5>
<p>
The problem with clip paths is back again due to two regressions in <strong>Android 6.0</strong>.  Any SVG files that use a <code>&lt;clipPath&gt;</code> will not render correctly.
See <a href="https://code.google.com/p/android/issues/detail?id=200128" rel="nofollow">Android issue 200128</a>.  Unfortunately,
this time, this bug affects both <code>renderToPicture()</code> and <code>renderToCanvas()</code>.</li>
</p>
<p>
To avoid this issue, please upgrade to AndroidSVG 1.3, which has new improved handling of clip paths. The new code avoids the above-mentioned
issue, but uses Android APIs that are only available on Android 4.4 (Kitkat) or later.  Older devices will continue to use the legacy clip path code.
</p>


<h4>Android 5.0 to 8.1</h4>

<a name="Erratically_spaced_text"></a>
<h5>Erratically spaced text</h5>
<p>
Font sizes that are not whole numbers can result in erratically spaced glyphs (characters) in your text.  This issue affects all versions
of Android from 5.0 (Lollipop) to 8.1 (Oreo), but is fixed in Android 9.0 (Pie).  See <a href="https://issuetracker.google.com/issues/37042531">Android issue 37042531</a>.
</p>
<p>
To work around this issue, upgrade to AndroidSVG 1.4 and avoid font sizes that have a fractional component.  Ie. Use "24", rather than "24.35".  It doesn't seem to matter what the
current scale or transform is.  It is the declared font size that matters.
</p>


        
        </section>
      </div>
    </div>

    <!-- FOOTER  -->
    <div id="footer_wrap" class="outer">
      <footer class="inner">
        <p class="copyright">AndroidSVG maintained by <a href="https://github.com/BigBadaboom">Paul LeBeau</a></p>
        <p>Published with <a href="https://pages.github.com">GitHub Pages</a></p>
      </footer>
    </div>

  </body>
</html>
